home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / misc~1 / 123 / stcitdoc.arc / UUCP.DOC < prev    next >
Encoding:
Text File  |  1987-11-22  |  4.5 KB  |  114 lines
  1. UUCP.DOC
  2.  
  3.             The UUCP gateway for STadel.
  4.  
  5.     STadel V3.1a supports a UUCP gateway via an auxilary program
  6. called UUCALL.TOS.  This is a mail-only gateway -- Usenet newsgroups
  7. may be supported in the future, but now you're stuck with mail only.
  8. To run UUCALL, you need the following things:  1) you need to put a
  9. network node called UUCP into your STadel network list (you must
  10. make this a receive-only node to avoid messy callout problems); 2)
  11. you need a UUCP network feed; and 3) you probably need a hard disk.
  12.  
  13.     UUCALL pulls mail messages destined for UUCP out of the STadel
  14. messagebase, calls your UUCP feed, and takes the messages delivered
  15. to you and puts them back into the STadel messagebase.  Messages
  16. addressed to 'root' or 'Postmaster' are sent to 'sysop' instead.
  17.  
  18.  
  19.     HOW UUCALL FIGURES OUT HOW TO TALK TO THE OUTSIDE WORLD:
  20.  
  21.     When UUCALL is executed, it attempts to look for a file called
  22. UUCP.SYS in your network directory (#netDir in your CTDLCNFG.SYS).
  23. Here is what the contents of UUCP.SYS should be like:
  24.  
  25.         tz    <your timezone>
  26.         system    <your system name>
  27.         login    <your uucp login on your newsfeed>
  28.         passwd    <your uucp password on your newsfeed>
  29.         path    <path from a backbone to your feed>
  30.         domain    <UUCP or blank>
  31.         address    <telephone number of your newsfeed>
  32.  
  33.         (the fields are TAB separated.)
  34.  
  35.     In my case (pell), the UUCP.SYS file looks like this:
  36.  
  37.         tz    GMT
  38.         system    pell
  39.         passwd    @@@@@@@@@@
  40.         login    pell
  41.         path    ihnp4!meccts!stag
  42.         address    222 6969
  43.     
  44.  
  45.     The system name and the login MUST follow Unix convention --
  46. alphanumeric characters only.  Your contact at the newsfeed can give
  47. you the domain, path, address, and timezone information.
  48.  
  49.  
  50.     HOW DOES IT, ER, WORK:
  51.  
  52.     Oooh, now we get to the nitty-gritty of calling UUCP.  If you
  53. want to send a message via uucp, you .g(oto) the mail> room and
  54. e(nter) a message -- when it asks you who to send the message to,
  55. you'll enter 'their!uucp!address@UUCP'. That's it.  The message will
  56. be saved like any other citadel netmail message, and UUCALL will add
  57. Date:, From:, To:, and Message-id: fields by itself.
  58.  
  59.     When messages come in, the message-headers are parsed out and
  60. discarded, except for the Date: field and the From: field, which are
  61. converted to STadel format.  When you reply to a message coming off
  62. the net, the address it is sent back to is the From: address, NOT
  63. the Reply-to: address, because that's been discarded.  If a incoming
  64. message is addressed to somebody that doesn't exist on your system,
  65. the message will be put in the network directory and a informative
  66. message will be put in your Aide> room.  (The same thing will happen
  67. with messages longer than 10K (10K is the maximum length of a STadel
  68. message.))
  69.  
  70.     Your host system must be set up as follows:  It MUST provide
  71. a login prompt that ends with `login:' and (if you are using
  72. a password) a password prompt that ends with `password:'.  Citadel
  73. does not understand UUCP, so your UUCP host CANNOT poll your site.
  74. There is a commandline option you can use to select the proper way
  75. to coerce your UUCP host into changing baudrates.  If you say
  76. `uucall -BREAK', uucall will send a BREAK to the host if it doesn't
  77. recognise a `login:' prompt when it calls the system.  (the default
  78. behavior is to have uucall send a return if it doesn't see a `login:'
  79. from the host.)
  80.  
  81. UUCP host 
  82.     RESTRICTIONS:
  83.  
  84.     There is one restriction on using UUCP -- your username must
  85. conform to Unix format (alphanumeric characters only.) If 'John Q
  86. Alias' tries to send UUCP mail, UUCALL will refuse to send the
  87. message. (you can use the utility LOGEDIT to change their alias so
  88. it's Unix-compatable.)
  89.  
  90.     EXAMPLE:
  91.  
  92.     On Pell, I've got UUCALL set up to automatically call my
  93. newsfeed twice a day (3:00am and 3:00pm) via a shell program and
  94. #events. My CTDLCNFG.SYS has two events for UUCP:
  95.  
  96.     #event PREEMPTIVE 3:00 0 uucp 10
  97.     .
  98.     .
  99.     #event TIMEOUT   15:00 0 uucp 10
  100.  
  101.     So at 3:00am or pm, Pell kicks the users off and exits,
  102. returning with status 10.  My shell program then executes UUCALL,
  103. then pops back into citadel.
  104.  
  105.     SO, WHO WROTE THIS PROGRAM ANYWAY:
  106.  
  107.     UUCALL is based very* roughly on the UUSLAVE program that can be
  108. found in various places around the country.  Dale Schumacher (Dalnefre')
  109. converted UUSLAVE into UUMASTER, and David Parsons (orc) wrote the
  110. STadel interface code and converted UUMASTER into UUCALL.
  111.  
  112.     If you have any questions or comments, please drop me a line 
  113. (UUCP: ihnp4!pell!orc  BBS: orc @ Pell 612-377-9239)
  114.